---
title: Controller - OSRAM AC025XX00NJ SMART+ Switch Mini
description: Controller automation for executing any kind of action triggered by the provided OSRAM AC025XX00NJ SMART+ Switch Mini. Supports Zigbee2MQTT, ZHA, deCONZ.
model: AC025XX00NJ
manufacturer: OSRAM
integrations: [Zigbee2MQTT, ZHA, deCONZ]
model_name: OSRAM AC025XX00NJ SMART+ Switch Mini
---

import {
  Input,
  Inputs,
  Requirement,
  ImportCard,
  Changelog,
} from '/src/components/blueprints_docs'

<ImportCard id='osram_ac025xx00nj' category='controllers' />

<br />

:::tip
This blueprint is part of the **Controllers-Hooks Ecosystem**. You can read more about this topic [here](/docs/controllers-hooks-ecosystem).
:::

## Description

This blueprint provides universal support for running any custom action when a button is pressed on the provided OSRAM AC025XX00NJ SMART+ Switch Mini. Supports controllers integrated with Zigbee2MQTT, ZHA, deCONZ. Just specify the integration used to connect the remote to Home Assistant when setting up the automation, and the blueprint will take care of all the rest.

In addition of being able to provide custom actions for every kind of button press supported by the remote, the blueprint allows to loop the long press actions while the corresponding button is being held. Once released, the loop stops. This is useful when holding down a button should result in a continuous action (such as lowering the volume of a media player, or controlling a light brightness).

The blueprint also adds support for virtual double button press events, which are not exposed by the controller itself.

:::tip
Automations created with this blueprint can be connected with one or more [Hooks](/docs/blueprints/hooks) supported by this controller.
Hooks allow to easily create controller-based automations for interacting with media players, lights, covers and more. See the list of [Hooks available for this controller](/docs/blueprints/controllers/osram_ac025xx00nj#available-hooks) for additional details.
:::

## Requirements

<Requirement id='zigbee2mqtt'/>
<Requirement id='zha'/>
<Requirement id='deconz'/>
<Requirement name='Input Text Integration' required>

This integration provides the entity which must be provided to the blueprint in the **Helper - Last Controller Event** input. Learn more about this helper by reading the dedicated section in the [Additional Notes](#helper---last-controller-event).

[Input Text Integration Docs](https://www.home-assistant.io/integrations/input_text/)

</Requirement>

## Inputs

<Inputs category='controllers' id='osram_ac025xx00nj' />

## Available Hooks

:::note Virtual double press actions
Some of the following mappings might include actions for virtual double press events, which are disabled by default.
If you are using a hook mapping which provides an action for a virtual double press event, please make sure to enable support for virtual double press on the corresponding buttons with the corresponding blueprint input.
:::

### Light

This Hook blueprint allows to build a controller-based automation to control a light. Supports brightness and color control both for white temperature and rgb lights.

#### Default Mapping

- Up button short press -> Brightness up
- Up button long press -> Brightness up (continuous, until release)
- Up button double press `Virtual` -> Color up
- Down button short press -> Brightness down
- Down button long press -> Brightness down (continuous, until release)
- Down button double press `Virtual` -> Color down
- Center button short press -> Toggle

[Light Hook docs](/docs/blueprints/hooks/light)

### Media Player

This Hook blueprint allows to build a controller-based automation to control a media player. Supports volume setting, play/pause and track selection.

#### Default Mapping

- Up button short press -> Volume up
- Up button long press -> Volume up (continuous, until release)
- Up button double press `Virtual` -> Next track
- Down button short press -> Volume down
- Down button long press -> Volume down (continuous, until release)
- Down button double press `Virtual` -> Previous track
- Center button short press -> Play/Pause
- Center button long press -> Toggle

[Media Player Hook docs](/docs/blueprints/hooks/media_player)

## Additional Notes

### Helper - Last Controller Event

The `helper_last_controller_event` (Helper - Last Controller Event) input serves as a permanent storage area for the automation. The stored info is used to implement the blueprint's core functionality. To learn more about the helper, how it's used and why it's required, you can read the dedicated section in the [Controllers-Hooks Ecosystem documentation](/docs/controllers-hooks-ecosystem#helper---last-controller-event-input).

### Virtual double press events

It's also important to note that the controller doesn't natively support double press events. Instead , this blueprint provides virtual double press events. You can read more about them in the [general Controllers-Hooks Ecosystem documentation](/docs/controllers-hooks-ecosystem#virtual-events).

This blueprint supports any variant of the Osram SMART+ Switch Mini controller (AC025XX00NJ). Different model IDs (AC0251100NJ, AC0251400NJ, AC0251600NJ, AC0251700NJ) represent just a different device color.

## Changelog

<Changelog category='controllers' id='osram_ac025xx00nj' />
